…t/docs/for-agents

Closes 9 personal-dogfood + BUG-PAYMENT findings discovered in the 2026-05-29
QA sweep. Each fix carries a code-comment with the DOG-/BUG- ID and the
behavior contract for the regression guard.

Funnel impact (Team self-serve + lost-context redirect):

- DOG-1, DOG-10, BUG-P003: Team CTA mailto:support@instanode.dev flipped to
  /app/checkout?plan=team&frequency=monthly|yearly on both MarketingPage and
  PricingPage. Self-serve Team is live as of api#168 + dashboard #106; the
  prior mailto contradicted the H2 'Self-serve at every tier' on the same
  page and leaked mid-funnel conversions on the $199/mo AOV path.
- DOG-9, BUG-P013: AuthGate now redirects unauthenticated /app/* visits to
  /login?next=<encoded path> on the URL (not just React Router state). State
  doesn't survive OAuth or magic-link callbacks — net effect was every
  logged-out 'Start hobby' click landed back on /app/dashboard with all plan
  + frequency context lost. New App.authgate.test.tsx pins the contract.

Copy honesty (DOG-3 + DOG-11 + DOG-47/48):

- DOG-11: 'Self-serve at every tier' H2 → 'Self-serve sign-up at every
  tier'. The signup direction is honest; cancellation/downgrade stays
  support-only per the intentional policy (memory:
  project_no_self_serve_cancel_downgrade.md).
- DOG-3, BUG-P001: hobby_plus + growth tiers were FAQ-only despite the
  'every tier' promise. Added 'Between the headline tiers' inline section
  on PricingPage with per-tier markers + cross-link from the FAQ entry. The
  comparison table stays 4-column (cleaner first-time funnel); the inline
  callout makes the intermediate tiers discoverable.
- DOG-47/48: 'Try the curl' CTAs renamed to 'See the curl' (landing + pricing).
  Both anchors land on static screenshots, not REPLs — the previous label
  false-promised interactivity. Building a real playground is separately
  scoped.

DocsPage (DOG-33 + DOG-34):

- DOG-33: search input now filters the MAIN article column too, not just the
  sidebar TOC. Previously typing 'razorpay' left every <section> visible in
  the body. Empty-query renders all sections; no-match renders the empty
  state.
- DOG-34: Edit-on-GitHub link moved OUT of the <h2> into a .docs-section-header
  sibling. Screen readers used to announce section titles as 'QuickstartEdit on
  GitHub ↗'; the new header preserves the visual side-by-side layout while
  keeping the heading clean for AT and the document outline.

For-agents page (DOG-39):

- DOG-39: added 'instanode CLI' integration card with the curl|sh one-liner.
  cli#18 + .goreleaser.yml release notes documented the install path but the
  page only listed MCP runtimes; the cli persona was invisible. DOG-38 was
  already fixed (aria-label='Copy …' on each copy button).

Tests added (1081 passing, 0 failing — was 1075 before):

- src/App.authgate.test.tsx (NEW): pins ?next= preservation contract,
  including the bare-/app no-query case and the token-present passthrough.
- PricingPage.test.tsx: Team CTA points at /app/checkout?plan=team
  (monthly default + ?frequency=yearly URL-param variant), 'Between the
  headline tiers' section + per-tier markers.
- DocsPage.test.tsx: search filters main column on no-match; empty query
  renders everything; Edit link is a sibling of h2, not a child.

Coverage block:

  Symptom:        marketing CTAs / a11y / SPA redirect drops query
  Enumeration:    rg 'Team plan inquiry', 'Try the curl', 'Self-serve at every tier'
  Sites found:    8 distinct surfaces
  Sites touched:  8 (all enumerated above)
  Coverage test:  new tests in App.authgate / PricingPage / DocsPage
  Live verified:  awaiting deploy (curl /pricing | grep '/app/checkout?plan=team')

Rule 22 multi-surface notes:

- llms.txt was updated by the prebuild fetch-content step (unrelated to
  this PR — content repo had drift).
- Dashboard checkout copy (upgradeCopy.ts) does not need updates — these
  changes are marketing-side only; CheckoutPage itself already handles the
  ?plan=team case via the ALLOWED_PLANS list.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Patch-coverage gate flagged 4 lines uncovered:
- src/App.tsx:208,211-212 — AuthGate body. Previous test imported a parallel
  AuthGate copy in the test file rather than the real export, so the gate's
  diff-cover saw 0% on the new lines. Fix: export AuthGate from App.tsx and
  import it directly. Same 3 cases, now hit the real implementation.
- src/pages/DocsPage.tsx:246 — the filter() predicate at the section-render
  loop. Added an explicit matching-query test that exercises both branches
  (visibleIds === null when query is empty, visibleIds.has(s.id) when there
  is a query).

Local gate now 1082 passed / 0 failed (was 1081 — added 1 new test).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>